home *** CD-ROM | disk | FTP | other *** search
/ Animation How-To / Animation How-to CD.iso / READ.ME
Text File  |  1994-01-01  |  32KB  |  622 lines
  1.   ===============================READ.ME===========================
  2.  
  3.  This CD is organized into 4 basic directories:
  4.  
  5.    1) PLY      -Alexander Enzmanns ray tracer program POLYRAY v 1.6a.
  6.                 Eight separate chapter directories off this one are
  7.                 further broken down into separate topics, containing
  8.                 the source code for all the flics in the book.
  9.  
  10.    2) DTA      -Dave's TGA Animator to create flics from a series of TGA's
  11.                 It actually does a great deal more than that, so be sure
  12.                 to read the DOC's.
  13.  
  14.    3) AAPLAYHI -Autodesks Flic/GIF viewer.  It requires configuration
  15.                 before use but it works with almost any video system.
  16.  
  17.    4) FLY      -All the actual flics (about 480 meg)
  18.  
  19.  
  20.   INSTALLATION
  21.  
  22.   It's unlikely you'll want to load the flics on your hard drive, but you'll
  23.   need to transfer the first three items to your hard drive before using
  24.   them.  This requires about 5 meg of free hard disk space.
  25.  
  26.   There is no install program, it's simply a matter of copying these
  27.   files with the XCOPY command to your hard drive.  For example, assuming the 
  28.   CD-ROM drive is E: and your hard drive is C:, create a directory on the 
  29.   C: drive called \PLY,
  30.  
  31.      md \PLY
  32.  
  33.   change to that directory
  34.  
  35.  
  36.      cd \PLY
  37.  
  38.   and type:
  39.  
  40.      xcopy e:\PLY\*.* /s 
  41.  
  42.   This will transfer everything automatically, including the directory 
  43.   structure.  You might also want to copy only one chapter at a time. 
  44.   This could be accomplished by:
  45.    
  46.      xcopy e:\PLY\CHAPTER1\*.* /s
  47.  
  48.   Repeat this process for both the \DTA and \AAPLAYHI directories.  Create
  49.   directories on your hard drive and then xcopy /s the files over to the 
  50.   hard drive.
  51.  
  52.  
  53.   PATHS
  54.  
  55.   In order to run DTA and AAPLAYHI, they either must be in your DOS PATH
  56.   or be called from a batch file.  I personally have a \TOOLS directory 
  57.   where DTA resides, and a PATH statement in my AUTOEXEC.BAT file reads:
  58.  
  59.      C:\;C:\DOS;C:\TOOLS...
  60.  
  61.   AAPLAYHI is such a mouthful that I have a batch file called AA.BAT in
  62.   my tools directory that reads:
  63.  
  64.      \AAPLAYHI\AAPLAYHI %1
  65.  
  66.   This lets me type AA followed by either a script file or a flic file
  67.   name.  Using a batch file allows me to run the flic viewer without having 
  68.   to lengthen my PATH statement to include \AAPLAYHI.
  69.  
  70.   Another batch file I use is PR.BAT (also in my tools directory), that 
  71.   contains the line
  72.  
  73.      \PLY\POLYRAY %1.PI %2 %3 %4 %5 %6 %7 %8
  74.  
  75.   This calls Polyray simply by entering PR and the name of the data
  76.   file without the .PI extension.  The additional %#'s allow command line
  77.   options to be passed to Polyray.  The one I use most is -R, but you can 
  78.   also set most important variables on the command line.  I usually use
  79.   options defined in POLYRAY.INI to control most variables.  See the 
  80.   Polyray .DOC's for more details.
  81.  
  82.   
  83.   \FLY
  84.  
  85.   All the flics in the book are in the FLY directory. They take up quite a 
  86.   bit of room.  Unless you have the spare space, you'll probably want to 
  87.   leave them on the CD and view them from there.  
  88.  
  89.   CD data transfer rates are terribly slow, too slow to play most flics 
  90.   smoothly.  You might copy individual flics to a temporary holding area 
  91.   on your hard drive (\TEMP or \FLICS) and watch them from there.  
  92.  
  93.   Calling AAPLAYHI without an argument allows you to LOAD a flic first into 
  94.   memory, making the playback much smoother.  
  95.  
  96.   The script files on the CD that play all the flics sequentially were 
  97.   written to allow a quick overview.  However, they don't specify preloading
  98.    the flics into memory.  
  99.  
  100.   If the flic you wish to view is larger than available RAM, AAPLAYHI will 
  101.   inform you that it can't find enough memory, and ask if you want to view 
  102.   it directly from the disk.  A batch file that preloaded all the flics first 
  103.   would have produced a long series of "can't load" messages on most systems,
  104.   so a simpler version was used by default.  If you have lots of RAM, edit 
  105.   the supplied script files (.SCR) with "loadflic" and "freeflic" 
  106.   options:
  107.  
  108.      loadflic \FLY\CHAPTER1\COIN\FLIP.FLI
  109.      \FLY\CHAPTER1\COIN\COIN.FLI -L 100
  110.      freeflic \FLY\CHAPTER1\COIN\FLIP.FLI
  111.  
  112.      loadflic \FLY\CHAPTER1\COINZ\FLIP.FLI
  113.      \FLY\CHAPTER1\COIN\COINZ.FLI -L 100
  114.      freeflic \FLY\CHAPTER1\COINZ\FLIP.FLI
  115.      ...
  116.  
  117.   It will play the flics much faster, but there will be a load pause before 
  118.   each image moves.
  119.  
  120.  
  121.   BONUS
  122.  
  123.   A bonus track of recent or interesting flics has been included, with a 
  124.   subdirectory /SRC off it containing most (but not all) of the source code
  125.   for these flics.  You should be able to figure out most of the effects
  126.   yourself, and when debating whether to omit these flics or scrounge the
  127.   tapes to find the sources, I decided to find as much as I could and leave
  128.   it at that.  REFLEX is my current favorite, and the source for that is
  129.   included.
  130.  
  131.  
  132.   LAST MINUTE ITEMS - Don't worry about these, I already have.
  133.  
  134.   9CROSS7.FLI in the \CHAPTER7\STARS directory is an animation created
  135.   with Polyray 1.5.  This requires a bug that Alexander fixed in v 1.6
  136.   It's included just to show you what the original animation looked like.
  137.   No source is included, and anyway having two versions of Polyray on 
  138.   the disc would have been confusing.
  139.  
  140.   SHATTER was extended to 192 triangles after that section was completed.
  141.   All the necessary code to extend it has been included. 
  142.  
  143.   The TESTANIM animation should probably be slowed way down (/S6).
  144.  
  145.   SWARM needs to rotate.  Define the mass as a single object and do
  146.   a rotate on it.
  147.  
  148.   ANGRY is better if it doesn't flicker.  Try disabling the texture flipping
  149.   code.
  150.  
  151.   Many of the developmental animations for VOLCANO are included without
  152.   the corresponding code.  The final animaiton code is included, but I 
  153.   couldn't find the developmental code.  Sorry, some of those are fun.
  154.  
  155.   The various MTV data files don't necessarily correspond to the numbers on
  156.   the flics.  
  157.  
  158.   CLRSPACE in chapter6\sphere concerns visualizing the default colors in
  159.   Polyray.  An RGB cube with the color indices controlling the positions 
  160.   of the spheres was used to generate the image.  It's included since it
  161.   deals with the subject of color space, but isn't covered otherwise in
  162.   that section. 
  163.  
  164.   The TUNL animation runs 479 frames - for a smooth loop point, delete the  
  165.   last two frames.
  166.  
  167.  
  168.   DIRECTORIES
  169.  
  170.   The PLY and FLY directories have identical subdirectoy structures.  One
  171.   contains the data files, the other one the flics.  The following listing
  172.   shows the parallel structure.
  173.  
  174.    ===========                             ===========
  175.      FLICS                                    CODE
  176.    ===========                             ===========
  177.  
  178.   \FLY\ALL                               \PLY\ADDENDUM
  179.   \FLY\ALL.SCR                           \PLY\COLOR.DOC
  180.   \FLY\BONUS.SCR                         \PLY\COLORS.INC
  181.   \FLY\CHAPTER1.SCR                      \PLY\POLYRAY.DOC
  182.   \FLY\CHAPTER2.SCR                      \PLY\POLYRAY.EXE
  183.   \FLY\CHAPTER3.SCR
  184.   \FLY\CHAPTER4.SCR
  185.   \FLY\CHAPTER5.SCR
  186.   \FLY\CHAPTER6.SCR
  187.   \FLY\CHAPTER7.SCR
  188.   \FLY\CHAPTER8.SCR
  189.   \FLY\README
  190.   
  191.   \FLY\CHAPTER1\COIN                     \PLY\CHAPTER1\COIN
  192.   \FLY\CHAPTER1\COIN\COINZ.FLC           \PLY\CHAPTER1\COIN\AA.CFG
  193.   \FLY\CHAPTER1\COIN\COINZ.FLI           \PLY\CHAPTER1\COIN\COIN.PI
  194.   \FLY\CHAPTER1\COIN\COINZ2.FLC          \PLY\CHAPTER1\COIN\COIN1.PI
  195.   \FLY\CHAPTER1\COIN\COINZ2.FLI          \PLY\CHAPTER1\COIN\COIN2.PI
  196.   \FLY\CHAPTER1\COIN\FLIP.FLI            \PLY\CHAPTER1\COIN\COIN3.PI
  197.                                          \PLY\CHAPTER1\COIN\COIN4.PI
  198.                                          \PLY\CHAPTER1\COIN\COIN5.PI
  199.                                          \PLY\CHAPTER1\COIN\POLYRAY.INI
  200.   
  201.   \FLY\CHAPTER1\TEST                     \PLY\CHAPTER1\TEST
  202.   \FLY\CHAPTER1\TEST\CLOCK.FLI           \PLY\CHAPTER1\TEST\POLYRAY.INI
  203.   \FLY\CHAPTER1\TEST\SMLCLOCK.FLI        \PLY\CHAPTER1\TEST\TESTANIM.PI
  204.   
  205.   \FLY\CHAPTER1\TUMBLE